Skip to content

docs(AGENTS.md): add design principle #3 — maximize feature surface through composition#1138

Merged
christso merged 1 commit intomainfrom
docs/composition-design-principle
Apr 17, 2026
Merged

docs(AGENTS.md): add design principle #3 — maximize feature surface through composition#1138
christso merged 1 commit intomainfrom
docs/composition-design-principle

Conversation

@christso
Copy link
Copy Markdown
Collaborator

Summary

  • Add new design principle Refactor #3 to AGENTS.md: Maximize Feature Surface Through Composition
  • Concrete examples showing 4 patterns achievable via existing primitives
  • Renumbers existing principles 3-6 → 4-7

Context

During competitive research (Margin Eval), we proposed 5 new AgentV features and closed 4 of them because existing primitives already covered them:

Pattern Not a feature — it's...
Oracle validation A cli provider target running a reference solution
Snapshot MCP for benchmarks Frozen data in workspace template + hooks
Harness variant comparison Target hooks with different setup scripts
Skill evaluation tool-trajectory + execution-metrics + rubric via composite

The principle was implicit across sections 1, 2, and 6 but never stated explicitly. Making it a named principle prevents future feature proposals that duplicate what composition already provides.

Risk

low — docs only

…hrough composition

Add explicit principle that AgentV should achieve maximum feature surface
with minimum primitives. Includes concrete examples showing how oracle
validation, snapshot MCP, harness variant comparison, and skill evaluation
are all composable from existing primitives (targets, hooks, evaluators,
workspace templates) rather than requiring dedicated features.

Renumbers existing principles 3-6 → 4-7.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@christso christso merged commit b4adcd3 into main Apr 17, 2026
3 of 4 checks passed
@christso christso deleted the docs/composition-design-principle branch April 17, 2026 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant